Annotate the GtkFunctionListItemFactory constructor
authorEmmanuele Bassi <ebassi@gnome.org>
Sun, 31 May 2020 14:14:26 +0000 (15:14 +0100)
committerEmmanuele Bassi <ebassi@gnome.org>
Sun, 31 May 2020 14:14:26 +0000 (15:14 +0100)
But skip it, since it cannot really be used by language bindings, as it
binds the same user data to two separate functions.

gtk/gtkfunctionslistitemfactory.c

index 2f179c332df0f31ba931823b7b02527db930738c..e625331b8b52d8b6c80c072e1b7b48be40a9c166 100644 (file)
@@ -101,6 +101,17 @@ gtk_functions_list_item_factory_init (GtkFunctionsListItemFactory *self)
 {
 }
 
+/**
+ * gtk_functions_list_item_factory_new: (skip)
+ * @setup_func: (scope call) (destroy user_destroy): the setup function for the list item factory
+ * @bind_func: (scope call) (destroy user_destroy): the bind function for the list item factory
+ * @user_data: user data for the @setup_func and @bind_func functions
+ * @user_destroy: a function called to destroy @user_data
+ *
+ * Creates a new #GtkListItemFactory with the given functions.
+ *
+ * Returns: (transfer full): the newly created list item factory object
+ */
 GtkListItemFactory *
 gtk_functions_list_item_factory_new (GtkListItemSetupFunc setup_func,
                                      GtkListItemBindFunc  bind_func,